home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / prtcs155.zip / FREQIT.DOC < prev    next >
Text File  |  1994-01-14  |  6KB  |  139 lines
  1.  
  2. FREQIT V1.0 by Sean Mollitt
  3.  
  4. preliminary docs:
  5.  
  6.  
  7. A file request door. This door was created to make freqing files easier for
  8. Sysops and users (optional). It will read and process every file list i've
  9. encountered so far (though I'm sure there must be one that won't work). What
  10. it does is parse the file list, adds numbers (for marking -thus eliminating
  11. typo's) and pulls the filename, bytes, date and description from each line.
  12. (it actually re-formats the display on-the-fly so you'll never get a column
  13. out of line)
  14.  
  15. it works with file lists with the following formats:
  16.  
  17. filename.lha  345678  12-jan-92   A file about filenames used in naming
  18.                                   files for the purpose of filing names.
  19. or... 
  20. filename.lha    345k  12-jan-92   A file about filenames used in naming
  21.                   ^^              files for the purpose of filing names.
  22. or...
  23. filename.lha  345678   12-01-92   A file about filenames used in naming
  24.                           ^^      files for the purpose of filing names.
  25. or...
  26. filename.lha        345678        A file about filenames used in naming
  27.                                   files for the purpose of filing names.
  28.  
  29. If anyonce runs across another format, please send me a sample and I'll
  30. work it in. in the Freqit.cfg file these different formats are reffered
  31. to as: NBDI (name bytes date info), NKDI (name kilobytes date info),and
  32. NBI (name bytes info) and NKI (name kilobytes info).
  33.  
  34. INSTALLATION:
  35.  
  36. you should have the following files in the freqit archive:
  37.  
  38.   FREQIT.rx        <- main executable
  39. * FREQIT.msgtxt    <- txt used by MM to inform user of waiting freqs
  40. * FREQIT.hlp       <- Help file
  41. * FREQIT.txt       <- File diplayed after files ahve been marked for freqing
  42. * FREQIT.cfg       <- configuration file
  43.   FREQIT-OUT.rx    <- outgoing freq processor, rx'it nightly in your cron
  44.               (not finished this one yet)
  45.   FREQIT-IN.rx     <- incomming freq processor, rx'it nightly in your cron
  46.               (after freqit-out -like maybe an hour later)
  47.   FREQIT.log       <- log file of incomming freqs
  48.   FREQIT.usr       <- list of file requests by user. maintained by freqit
  49.   FREQIT.doc       <- what yer reading
  50.  
  51.   EILIST.TXT       <- sample file partial list (my bbs) so you can see this
  52.               thing work. Put it whever you set "FILELISTDIR" in your
  53.                       Freqit.cfg file
  54.  
  55. * means you can edit this to you needs. dont mess with the others unless
  56.   you can program arexx and can follow my convoluted kludgy code. (hey it
  57.   works!)
  58.  
  59. create a directory in your "doors:" called "freqit" copy all the files from
  60. the archive to this directory (except EILIST.TXT). insert the following line
  61. in your filemenu.src file (or whereever) and compile it. 
  62.  
  63. REXX "^30000^1^doors:FREQIT/FREQIT.rx"
  64.  
  65. the stack size I used is arbitrary, if you think it will run with less,
  66. go for it.
  67.  
  68. The next thing you want to do is edit the freqit.cfg file. this is well
  69. commented so you should have no trouble with it. Be sure *NOT* to put tabs
  70. in the file since I made no provisions for stripping them out (I'll no
  71. doubt fix this later) also having any spaces in the paths you specify in
  72. this file will probably break it (also on the to do list).
  73.  
  74. the main thing you want to do here is add any file list you want the
  75. program to use. the individual bbs list info follows the keyword "BBSLIST"
  76. and ends with a blank line. Enter the bbs name (for the freqit menu),
  77. followed on the next line by the name (not a path) of the file list for that
  78. bbs. the next line should be the node address followed by the time schedule
  79. that bbs uses for freqs. Next is a word that defines the type/format of file
  80. list (NBDI, NKDI, NBI - see above) make sure you set this right. The last 
  81. line is the min access needed to see that list. This way you can have your
  82. own personal lists as well as ones that the users will see.
  83.  
  84. Freqit makes use of 4 other xenolink utilities: 
  85.  
  86. "Mail Machine" by Janne Paakkonen 
  87. (for notifying users of incomming freqs and file attaches),
  88.  
  89. "XquickAdd" by Magnus Lilja 
  90. (for freqing files automatically into your file catalogues -may not be 
  91. enabled in this release) 
  92.  
  93. "Freq" by Jonathan Forbes
  94. (for creating the .REQ files -included in your xenolink archive/disk).
  95.  
  96. You also need the WB 2.0 cli command "search" for the file search routine.
  97.  
  98. this last one may mean that this door will not function properly under 1.3
  99. let me know.
  100.  
  101. freqit needs to be able to find these files in your paths in order to work.
  102.  
  103. oh ya, you'll need the rexxsupport.library, but you'll no doubt have this
  104. if your using arexx
  105.  
  106. once you have freqit set up and feel confident it can work for you, edit
  107. your cron file so that you run FREQIT-OUT.rx and FREQIT-IN.rx at least once
  108. a night. What you want to do is set up a Freqing "window" so that
  109. FREQIT-OUT can generate the nessesary .REQ files and call out for the files
  110. afterwhich you can run FREQIT-IN.rx to check incomming files and process
  111. them accordingly.
  112.  
  113. this doc file is preliminary, I'll work on it some more once I add a few
  114. more features I've been thinking about.
  115.  
  116. anyway you'll figure it out.
  117.  
  118. You can reach me if you want to give me shit for realeasing such a pile of
  119. crap, or you want to congratulate me on my noble effort, in the Xenolink
  120. echos or in person on my board:
  121.  
  122. Electronic Image (14.4k DS/HST)
  123. 514-937-9984 
  124. Fidonet      1:167/165
  125. Amiganet    40:500/165
  126.  
  127. ACKNOWLEDEGMENTS: 
  128.  
  129. Janne Paakkonen  for Mail Machine, never used it till now, it's wonderfull!
  130. Magnus Lilja     for Xquickadd and other terrific "less is more" utilities
  131. Jonathan Forbes  for Z3, for that comfortable confident feeling all
  132.                  sysops should enjoy.
  133.  
  134. LEGALESE:
  135.  
  136. I take no responsibily whatsoever for anything that may go wrong while using
  137. this program. (wonder if that covers me?)
  138.  
  139.